.. _cmlGnGetNodeInfo:

cmlGnGetNodeInfo
================================
--------------------------------


SYNOPSYS
`````````````
.. code-block:: none

    VT_I4 cmlGnGetNodeInfo ([in] VT_I4 BoardID, [in] VT_PI4 Axis, 
    [out] TSlaveInfo *SlaveInfo )  

DESCRIPTION
`````````````  

- 해당 축에 연결된 슬레이브 정보를 반환합니다. 이 함수를 통해 해당 슬레이브의 종류(Servo/IO)와 I/O 
  슬레이브인 경우 슬레이브에 연결된 모듈 개수 및 연결된 모듈의 ID와 종류를 알 수 있습니다.  

\

- 이 함수의 사용과 호출에 있어, 제공된 ㈜커미조아의 함수 헤더 Visual Basic 에서는 함수의 첨두어 
  cml가 붙지 않습니다.  


PARAMETER
```````````````

▶ BoardID: 사용자가 설정한 디바이스(보드) ID.\ 
 
▶ Axis: 사용자가 제어하고자 하는 축(노드) 번호
 
▶ SlaveInfo: 이 매개변수를 통하여 슬레이브 정보를 반환합니다. 구조체(TSlaveInfo)로 되어 
있으며 구성은 다음과 같습니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Name, Meaning
   nSlaveType, 슬레이브 종류(Servo/IO)
   nNumModule, 연결된 모듈 개수
   ModuleType, 연결된 모듈 타입(Max_MODULE_IN_SLAVE(9) 크기의 배열)

▶ nSlaveType 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0
    
   Value, Meaning
   0(cmlST_SERVO), Servo Slave
   1(cmlST_IO), I/O(Input/Output) Slave
   2(cmlST_NETC), Ina Oriental Network Converter Slave
   -1(cmlST_NONE), None(연결되지 않음)

▶ ModuleType 

- 이 부분은 nSlaveType 이 1 (cmlST_IO) 인 경우에만 유효합니다. 

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0
    
   Value, Meaning
   0 (cmlMT_DO), ceDO32N 
   1 (cmlMT_DI), ceDO32N 
   2 (cmlMT_DIO), ceD16CM 
   3 (cmlMT_AI), ceAI08A 
   4 (cmlMT_AO), ceAO02A 
   5 (cmlMT_PM), ceMC02P 
   6 (cmlMT_NONE), None(연결되지 않음) 



RETURN VALUE 
````````````````

  .. csv-table::
   :widths: 10 90
   :header-rows: 1
   :stub-columns: 0

   Value, Meaning 
   음수, 수행 실패.
   ERR_NONE, 수행 성공.       




EXAMPLE
`````````````

.. code-block:: c++
 :linenos:

    C/C++ 
    
    #include “ComiMLink2_SDK.h” 
    #include “ComiMLink2_SDK_Def.h” 

    Long BoardID =  0; 
    TSlaveInfo SlaveInfo; 

    // 0번 축에 대한 정보를 반환합니다. 
    cmlGnGetNodeInfo(BoardID, 0, &SlaveInfo );